NOTE : There are now 2 versions of this mod! The complete mod (Succubus Heart) contains all the succubus stuffs while the HeartXP standalone only has the XP and Sperm system.

WARNING : V2.0.0 can not be installed over the base DfSV before it, You'll need to disable DfSV and enable the new Succubus Heart esp. Reasoning in the FAQ section - sorry!

<>-- Succubus Heart --<>
(Dragon from Succubus Valley + Heart XP)
Created By : Michael aka Spirit Shard

<> What is Succubus Heart? <>
Succubus Heart is a mod focused on integrated sex and succubus features in with gameplay and progression. To achieve this the player is given all the powers of a life force stealing Succubus! The player will be able to steal life force and either use it to strengthen themselves or turn it into dangerous spells.

<> Cool, cool.. so what's unique? <>
There's been a few Succubus mods around but the majority of them focus on the demon-like archetype. Succubus Heart is based on a non-succubus race (a race of life force weavers) and focuses more on creating a 'human-like' succubus. Without taking away the life stealing powers of course.

<> Story (Dragon from Succubus Valley) <>
[spoiler]
<> Dragon from Succubus Valley - Character Story <>
Two rival nations battling for the last of their precious pets. The Succubus army of Blood Heart takes on full assault into Casting Glaze, or as it's known to the humans, Succubus Valley. A lone Succubus resident rises from their victim's body as they hear the gates shatter - they are here for humans. The lone Succubus rushes on her way to warn the commander but is stopped by a large Blood Heart force. "It's over Moon Heart, we're taking them all!" Her once victim dragged alongside her as they headed for the shattered metal gates gives out a whisper, "You... You can help.." The Succubus looks down on the ragged man but is quickly surprised by a glow in his hand, "Help my... my homeland..." In a quick dash of light the man stands as destruction circles the two dragged prisoners, "THIS IS OUR FREEDOM."

The succubus wakes up in the middle of a castle surrounded by what appears to be.. humans? Delighted as she is, it's not long before she's tied up and put into a cell. "Oh well, at least they mistake me for some dragonborn hero."


<> Story - Succubus <>
The Succubus is a creature who gains power through the consumption of souls and Life Force, and the easiest way to get them is through.. oh, you know.. ^.-
[/spoiler]


<> Mechanics <>
[Spoiler]
<> General Mechanic Additions <>
- Males will give sperm to their partner when they orgasm
--- There is a bonus chance to receive double sperm and a chance of no sperm (load/dry)

<> Succubus Blessing <>
The player will be granted the powers of a life force stealing succubus giving her a range of abilities unique to her blessing.

()> Absorption Blessing
- Absorb base Health/Magicka/Stamina from others during Sex, stealing away their life force
--- Player = Aggressor multiplier is 100%
--- Player = Victim multiplier is 10%
--- Consensual multiplier is 50% but no harm is done to either participant

()> Succubus Delight
- Consume sperm for bonuses
--- Grants Health/Magicka/Stamina/HeartXP similar to sex
--- Gain bonuses for consuming sperm

()>  Succubus [Heart] Spells and Passives
- The player can learn Succubus Spells with varied abilities for seduction, combat, and support
- Learn passives to improve your overall performance

()> Succubus Heart system
- Gain HeartXP through sexual acts or succubus spells
--- HeartXP can be spent to increase the players stats/levels and learn new succubus spells

()> MCM ( DfSV-Succubus Heart )
- Check stats and level through the MCM

()> Built on SexLab Framework
--- Any sexlab animations will work with this mod!
[/Spoiler]

<> Requirements <>
- SKSE 1.07.01 [ http://skse.silverlock.org/ ]
--- It may run on an older/newer version but this is what I worked with.
- Sexlab v159c [ http://www.loverslab.com/topic/16623-skyrim-sexlab-sex-animation-framework-v159c-updated-oct-3rd/ ]
--- Or higher I assume
- SkyUI 4.1 [ http://www.nexusmods.com/skyrim/mods/3863/? ]
--- Or higher I assume. Needed for MCM.

<> Recommended Mods <>
[Spoiler]
<> Strongly Recommended Mods <>
- Skyrim -Community- Uncapper [ http://www.nexusmods.com/skyrim/mods/1175/? ]
--- For uncapping the level caps and adjusting leveling to accommodate for the new progression options. (I provide optional settings for uncapper as well)

<> 'just' Recommended Mods <>
- Defeat V5b3.3+ [ http://www.loverslab.com/topic/19941-defeat-v5b33fixed-805/?hl=defeated ]
--- Allows for a whole array of rape and such, plus the tie-up feature really helps out in big fights, or just to let your pet wait a little longer for pleasure. ^.-
- More Nasty Critters [ http://www.loverslab.com/topic/32953-more-nasty-critters/ ]
--- Large collection and additions to bestiality mods - a must have in my opinion.
[/Spoiler]

<> Recommended Settings <>
[Spoiler]
()> Skyrim -Community- Uncapper <()
I've provided an ini settings file as optional in order to set a little balance. This file contains a few changes...
-- Increased Caps to 999
-- Sets +5 carry weight to Health, Energy, and Magicka increase
After V2.1 multipliers were set to 100%.
[/Spoiler]

<> Compatibility <>
[Spoiler]
- Conflicts with mods that "lock" stats or increase/decrease them to maintain a specific value, luckily these mods are very rare since there's really no reason to do this..
- Compatibility with other succubus mods may be questionable do to overlap
- If you find anything else please let me know!
[/Spoiler]

<> Known Issues <>
[Spoiler]
- Players with intense script lag may have decreased effectiveness from absorption and other over time effects
--- To improve this reduce the amount of script your game is running. Sadly there's not much more I can do about this, I'll try my best to keep my script optimized the best I can.
- Female creatures will give sperm
--- Code limitation in Sexlab, sadly nothing I can do until gender specific creatures are supported
- Incorrectly tagged mods will negatively effect this mod (causing incorrect Succubus Effects to be used)
--- Sadly not much I can do about this but post if you find the mod and maybe we can get the author to fix it (or I'll fix it, because I'm like that)
- In higher script latency cases Seduction spells can 'stack' if cast twice with the first having an effect
--- Double animation seems to be canceled out by SexLab but Seduction Points may be taken twice.
[/Spoiler]

<> Installation / Updating <>
[Spoiler]
Merge the provided Data folder with your skyrim install, install 'Optional Uncap' if so desired. Enable in your mod manager of choice.

WARNING : if you had a version before V2.0.0 you'll need to disable the old DfSV.esp and enable the new SuccubusHeart.esp.  
[/Spoiler]

<> Uninstall / Removal <>
[Spoiler]
After V2.0
Disable the Mod in your mod manager of choice, load up your saved game you wish to uninstall it from, wait at least 10 seconds, save and exit. After this "clean save" you can delete SuccubusHeart.esp and files starting with SuH_.

Before V2.0
Disable the Mod in your mod manager of choice, load up your saved game you wish to uninstall it from, wait at least 10 seconds, save and exit. After this "clean save" you can delete all the files with "DfSV" at the start of the name from Data, Data/Script, and Data/Script/Source. Removing the files is not necessary for updating but is recommended if you had a version before V1.0.0 installed.
[/Spoiler]

<> FAQ <>
[spoiler]
<> Q and A <>
Q : Why can't this install over the old DfSV one? (V2.0.0 and up)
A : In my time before release 1.1 I had a hard drive crash, the update before V2.0.0 was actually an 'old' release which was slightly different than my working release. When I went to re-create my working files I began having large amounts of issues getting it to work correctly on my old install save, most likely do to naming problems (since I didn't have the old files for reference). This is what also sparked the 'name change'. Ultimately you don't 'have' to delete the files but having both versions running along-side each other is probably a bad idea.

Q : Can I still level like in vanilla?
A : Yep, this mod doesn't alter any external scripts so other leveling methods should not be effected.

Q : The MCM isn't showing and nothing seems to work!
A : Try a clean install of the mod, if that doesn't fix your issues it may not work on that save, try starting a new game. If you're still having trouble make a post and I'll help the best I can!

Q : What is the point when I can just have sex to heal?
A : This mod does not initially heal you! Before you train and learn the healing passives you'll only be gaining the absorbed Health (which isn't much) and even after the passives you may still not heal much.

Q : Why not just implement the HeartXP system and leave out the Health/Magicka/Stamina stuff?
A : Because it's a mod based on life force stealing! Personally I find the mechanic to be interesting and create a cool dynamic. However, if you want just the HeartXP system there's a standalone available alongside Succubus Heart for you peoples.

Q : When are the dialogue options going to be included?
A : Hopefully next update? As of 2.1 the framework is there, it's just not polished for release yet. I kind of want to release it with the 'trader' since a lot of that code overlaps, which may take a bit longer.
[/spoiler]

<> Change Log <>
[spoiler]
-V2.1 [Should be safe to install over V2.0]
--- *Adjusted* Optional Uncap settings
------- Settings were set to 100% skill gain, this is do to a shift in focus from solely using the Absorb mechanic to level and into a focus on using it for Succubus Spells and such
--- *Adjusted* code for better performance and easier updates
--- *Adjusted* SexLab Hooks for better passives support (Please let me know if something isn't working correctly)
--- *Adjusted* Spell learning message to match passives
--- *Adjusted* Focus Shot magicka cost to 20 (down from 30)
--- *Added* Seduction Points (used for seduction attempts)
------- This is essentially a replacement for what Heart Force was going to be from Version 1
--- *Adjusted* Meditation Spells from 10 HeartXP to 5 HeartXP (This also fixes the typo, was actually 10 not 20...)
--- *Added* Seduction Points to the 'Help' section
--- *Added* New Tier to Heart Passives
--- *Added* New Spell Type : Seduction
--- *Added* New Spell Type : Utility
--- *Added* New Spells
------- (Free) Sexual Enrage [Seduction] : Provoke a target to rape you by touch (100% Seduction Cost)
------- Silent Kiss [Seduction] : Attempt to seduce a consensual target by touch (100% Seduction Cost)
------- Creature Claim [Seduction] : Attempt to seduce a consensual creature by touch (60% Seduction Cost)
------- Mana Shroud [Utility] : Turn Invisible by sacrificing 2 Magicka a second (cancels when magicka is depleted, can be toggled)
--- *Added* New Passives
------- (Free) Succubus Prowl [Heart] : Generate 1 Seduction Point every 5 seconds
------- Seductive Delights [Heart T2] : Sperm grants 5 Seduction Points
------- Human Desires [Heart T2] : Acts with Humanoids yields 50% more base HeartXP
------- Animal Desires [Heart T2] : Acts with creatures yields 50% more base HeartXP
--- *Added* My own update system since SKYUI's doesn't work on all saves (So much frustration!)
------- I only mention this because it will pop-up messages on update
--- *Added* Now male homosexual orgasms should give each other sperm
------- 'should', because I'm not interested in testing it. Code makes sense tho.
--- *Removed* "...has already been learned" Messages when selecting a spell/passive you already learned
--- *Removed* "Not enough HeartXP" message as well
------- Wasn't a big deal, just felt redundant since it says "LEARNED" or cost next to it
--- *Fixed* Characters that are not being drained/engaged by player from being 'death checked'
--- *Fixed* MCM should now properly refresh when learning spells and passives
--- *Fixed* Perfect Orgasm should now activate properly when in solo animation

-V2.0.0 [Another large overhaul (I like doing these apparently). Disable the old DfSV.esp and enable the new SuccubusHeart.esp. It's safe to delete all the DfSV files. Succubus progress will be reset unfortunately]
--- NOTE : Because of the 'forced' reset caused by incompatibility with the older versions I went through and modified all the HeartXP values making the numbers much smaller and more reasonable
--- *Replaced* most old mechanics with new code (This comes with a lot of performance improvements)
--- *Replaced* MCM options with 'Text fields' rather than 'toggle fields' to create a cleaner UI
--- *Adjusted* Focus Shot : Sacrifices 1 Stamina and damages the target for 10 health (+1hxp on hit)
--- *Adjusted* mod name in MCM is now "Succubus Heart"
------- This is now the official name of the mod to reduce confusion from people thinking this is a quest line
--- *Adjusted* Standard polling rate is now 5 (up from 3, should 'lighten' the mod a good bit)
------- This also reduces gains, hoping to balance this with the new passives
--- *Adjusted* References to Magicka and Stamina to say Magicka and Stamina
------- Magic and Energy are pretty instinctive so I most likely missed one here and there...
--- *Adjusted* Sperm weight is now 0 (no weight)
--- *Adjusted* How Succubus Effects are applied (should fix a large number of issues)
--- *Adjusted* HeartXP Gain now effects spells
--- *Adjusted* HeartXP Gain and Cost values (All HeartXP values should be much lower)
--- *Adjusted* Level scaling to be lower at low levels but much higher at higher levels
--- *Adjusted* Victim values to 20% (up from 10%)
--- *Adjusted* Double sperm and No sperm to happen less often
--- *Added* If an NPC is out of magicka and/or Stamina it will drain from their health instead
------- This means you no longer have to level Health Absorption to kill enemies
--- *Added* If an NPC is out of a stat the player will not be able to absorb that stat
------- If the NPC is out of Magicka or Stamina it will still drain from Health instead, giving the absorption
--- *Added* 'Help' section got some filling out, will most likely add to it if questions arise
--- *Added* When a player is below a certain amount of max stat they will absorb 150% more
------- Value is determined by [100+(10*level)]
------- This will not effect NPCs
--- *Added* New Passives System!
--- *Added* New Spell and Passive Types
------- Battle Spells : Spells focused on dealing damage to the enemy
------- Heart Passives : Permanent upgrades
--- *Added* New Passives
------- Healthy Delights [Heart] : Sperm recovers 25% of missing Health
------- Shining Delights [Heart] : Sperm recovers 25% of missing Magicka
------- Sugary Delights [Heart] : Sperm recovers 25% of missing Stamina
------- Perfect Orgasm [Heart] : Orgasms recover 75% of missing Health/Magicka/Stamina
------- Special Lover [Heart] : Consensual partners recover 10% missing Health/Magicka/Stamina every 5 seconds
------- Caring Lover [Heart] : Grants consensual partners with bonus Health (1/5sec)
------- Magical Lover [Heart] : Grants consensual partners with bonus Magicka (1/5sec)
------- Lasting Lover [Heart] : Grants consensual partners with bonus Stamina (1/5sec)
------- Training State [Meditation] : Grants HeartXP at 1/5sec
------- Hunger State [Meditation] : Consumes Health at 1/5sec for HeartXP at 20/5sec
------- Focused State [Meditation] : Consumes Magicka at 1/5sec for HeartXP at 20/5sec
------- Bracing State [Meditation] : Consumes Stamina at 1/5sec for HeartXP at 20/5sec
--- *Added* status values to 'Heart Levels' (was HeartXP) in the MCM
--- *Added* A Rare Sperm Type
--- *Removed* Stat Decay system in response to the new passives system
------- People didn't like it anyways, to compensate I slowed stat gain.. hehe...
--- *Removed* Sperm Lover Passives (didn't work correctly anyways, replaced with new passives)
--- *Removed* Heart Force mechanics (planned mechanics moved into the new passives system)
--- *Removed* 'Settings' from the MCM (most suggestions moved into passives and such)
------- In my test builds settings were causing huge headaches, my liver can't take more painkillers!
--- *Fixed* Succubus effects not finding NPCs in some rare cases (was cause by spell immunities)
--- *Fixed* Some performance issues with the MCM
------- Looking into more optimization techniques to improve performance
--- *Fixed* Characters dieing from the death check when they still had health left
------- I apologize to all the dead wives, husbands, and followers that suffered this issue
--- *Fixed* Stats going negative when character was already damaged when leveling skills
------- This is done by healing the player upon leveling, may need to find another fix
--- *Fixed* HeartXP gain starting at level 100 (was a bit ridiculous to level)
--- *Fixed* Some words in the MCM not capitalizing properly
--- *Fixed* Sex Effects should no longer cause the 'brawl bug'

- V1.1.0 [NOTE : MCM performance will be slower than usual when leveling, this will be fixed in a later release]
--- Fixed [Heart] Focus Shot's typo
--- Adjusted level cost scaling
--- Consensual multiplier was set to 50% (was 80%)
--- Heart Focus is now given by default (no cost)
--- Increased Heart Focus cast cost to 30 magicka (was 10)
--- Heart Force is now effected by "Destruction Novice" perk (or at least should be)
--- Adjusted Dark Pierce learning cost to 50,000 (was 6,000)
--- Dark Pierce : Increased cast cost to 80 (was 30.. I think)
--- Dark Pierce : now effected by "Destruction Adept" perk (or at least should be)
--- Added a new spell type : Passive Spells
--- Sperm Lover passives were added to Passive Spells (Heart Spells)
--- Added description text for spells in the MCM (Now you know what they do before learning them)
--- **Added alchemy effects to sperm

- V1.0.1 [simple usability update]
--- MCM now refreshes when learning skills/increasing values (Numbers update immediately instead of needing to re-enter the page)
--- MCM now shows "req./status" on the SkillBurn menu for easier leveling(this will carry over to other pages if they grow large enough)
--- Fixed all the float values (hopefully)
--- Removed more unnecessary code (commented stuff I forgot to remove before, theoretically lowers load time)

- V1.0.0 [WARNING : With this release a clean save is REQUIRED]
--- Re-write of most script
--- Removed outdated variables and scripts (main reason for clean save requirement)
--- Values now pass through "Math.Floor" (this 'should' mean no more float values)
--- Effects under 1 will now value as 0 (no more slight increases over long durations)
--- Adjusted Spells to have a mana cost (again)
--- Removed Carry weight increase option (being moved into spells later on)
--- Changed "Increase HeartXP" Stat into a percentage
--- *WARNING* because of HeartXP changes HeartXP gain will revert to 100% when updating
--- Completely changed leveling values and requirements
--- Requirements now increase as skills/values increase (base requirements are a lot lower because of this)
--- Changed HeartXP values for actions (they are significantly higher than before)
--- Removed 20 status minimum (you can now lower a status down to 0)
--- Level up messages should now show effect (ex. "Alchemy Increased to 41")
--- "HeartXP" status added to HeartXP MCM
--- Removed extra effects from Sperm (these slots will be filled in a future update
--- *Bug* Some messages will still show float values (no actual negative effect, just visually unappealing)

- V0.7.0
--- *Fixed* Sperm not effecting stats
--- *Adjusted* Sperm values to give more HeartXP
--- *Adjusted* Status Cap to 100 + 15 per level
--- *Fixed* Status values staying at ##1 or ##9
--- (technically a fix) Removed mana cost from [Heart]Focus Shot spell
--- *Fixed* [Heart]Focus Shot should now be a hostile spell
--- *Added* New Spell [Heart]Dark Pierce
--- *Adjusted* absorption rate to 3 seconds
--- *Adjusted* decay rate to 9 seconds
--- *Fixed* attacker and victim adsorption reversing for NPCs

- V0.6.0
--- Heart Force usage changed
--- Heart Force will now be used only for spells and seduction attempts
--- Heart Force is no longer lost during sexual activity
--- Heart Force no longer effects gains/losses during sexual activity
--- New Spell "Force Shot" Added (find it under the Heart Spells MCM)
--- The minimum Health/Magicka/Stamina a player can have before decay is now increased with each player level (100 + 10/per level)
--- Skill Levels are now shown in the Soul Burn MCM (The page must be re-selected for changes to show)
--- Absorb Values are now shown in the Status MCM
--- Sperm values are now shown in the Status MCM
--- *Adjusted* sex type effects (As aggressor - 100% / As Consensual - 60% / As Victim - 10%)
--- *Fixed* Sperm not increasing status by the proper values
--- *Fixed* HeartXP Gain not increasing properly and decaying on some events
--- *Fixed* Heart Gain MCM not increasing properly
--- *Fixed* More improper values (when there's so many lines of code it's easy to miss things X.x)

- V0.5.2
--- Fixed improper labels
--- Minor check adjustments

- V0.5.1
--- The "HeartXP" options should now show a confirmation window like with skills
--- *fixed* being unable to level anything in the HeartXP page
--- *fixed* obsessive damage after sex (should now currently check with only 1 health damage. Reminder, if your partner only has 1 health remaining he/she will die, a more complex death check may be released in the next version)

- V0.5.0 [New Game is recommended - clean save may be enough]
--- Pretty much re-wrote everything
--- Large balance update (changed all values)
--- Changed Lowest Health/Magicka/Stamina the player can have to 20 (So be careful!)
--- The player now decay Health/Magicka/Stamina when over 100
--- Added in Gender Checks (Females should no longer give sperm)
--- All females should now receive sperm when there is a male partner
--- Sperm count increases when multiple males are present in the animation (there's still a chance someone will go dry tho!)
--- Partner Harm now implemented (for victims/aggressors, consensual harm will be available in a later update, the amount is determined by the character's absorption rates)
--- "Status" is now viewable in the Soul Burn MCM (Health/Magic/Energy/HeartXP)
--- High and Low Heart Focus now effect absorption and HeartXP gain at fixed amounts ( 150% on high and 50% on low )
--- You can now increase Absorption rate of Health/Magicka/Stamina in the MCM with HeartXP
--- You can now increase HeartXP gain in the MCM with HeartXP (a little ironic, I know)
--- You can now increase sperm effects in the MCM
--- A lot of "under the hood" improvements
--- *Removed* "Uninstall" option until I learn how to add it properly
--- *Removed* "Random Knowledge" Soul Burn effect
--- *Removed* "Soul Burn" Spells from .esp (they were outdated and not available by normal means anyway)
--- *Altered* Optional uncapper options (contains skills uncapped to 999 and skill multi at 0.4 for balance concerns)
--- *fixed* an issue with script updates and broken saves
--- *fixed/removed* "I feel a little weak..." debug spam when Heart Force is low
--- *fixed* females giving sperm
--- *Fix* Sperm's "Succubus Delight" effect now only works on the player as intended

- V0.4.1
--- [hopefully] Fixed Heart Force getting 'stuck' under zero
--- Fixed "Feeling a little weak..." from spamming console even when Heart Force isn't low
--- "Status" Screen now shows appropriate values (still in float form tho)

- V0.4.0 [Clean Save Required]
--- MCM menu has been added! (DfSV - Succubus heart)
--- New Status Menu Page in MCM
--- Soul Burn now available through MCM
--- Can now level individual skills at increased cost
--- Can now Increase Carry Weight just like a Skill
--- Added New HeartXP Mechanic (gained through sexual activity)
--- You can now spend HeartXP for individual skill ups
--- Added New Heart Force Mechanic (this replaces the plan for stamina effects to avoid conflicts with other mods)
--- Heart Force passively regenerates but decreases through sexual activity
--- You can now increase Max Heart Force and the regen rate of Heart Force with HeartXP
--- Heart Force now effects the benefits of sexual activity (being raped will lower it quicker than raping another)
--- Added a "player submit" effect for when the player is victim
--- Added chances to get a large load of sperm, or a dry run...
--- *Fixed* compatibility issue with health/stamina/magicka buffs
--- Added an "Uninstall" option under settings to stop quest scripts after uninstallations (doesn't work fully)
--- *Adjusted* optional uncapper settings
--- *Removed* Soul Burn spells from quest start-up (You can still find them using the console since they may return but their effects have not been updated to align with the new MCM options)
--- NOTE : Spells will be added as an option in the MCM on a later update if requested enough

- V0.2.0 [Clean Save Required]
--- SexLab Integration
--- Removed the need for SexLabUtil1 (if you were using V0.1.3 please disable the DfSV settings in SexLabUtil1)
--- With SexLabUtil1 gone there are no longer any required settings before play, just install and go!
--- Player now Gain stats during sex
--- Player now Gains bonus stats for being an Aggressor
--- Added Visuals to the "Soul Burn" skills (still lacks casting effect and menu image)
--- Sperm is now efficiently added (no more double sperm gain!)
--- *Broke* harm to opponent durring sex (you can use SexLabUtil1 if this is a needed feature)
--- *Adjusted* Sperm stat values (now that you gain stats during sex)
--- *Adjusted* and fixed a few Soul Burn effects (May need further adjustments)
--- *Adjusted* Optional uncapper settings to be closer to vanilla (now only uncaps all skills to 999 and reduces level multipliers to 0.8)

- V0.1.3
--- Concept Release
[/spoiler]

With the new passives system a whole new world of possibilities has arrived, so I'm looking for ideas! Also make sure to let me know of any issues you have with the mod, whether it be a bug or something you don't like, I want to hear it! Thanks, and Happy Hunting!